Online IVR Tutorial
Labels


Labels are used to indicate the destination point of a GoTo instruction. All labels in the Xtend IVR scripting language are declared with a starting or ending ‘:’ (colon). The labels are case insensitive; however, the normal convention is to use upper case to denote a label. There are certain pre-defined labels, which are executed under exceptional conditions.

Examples

ONTIMEOUT

This label is called when the time between Answer and Hangup commands exceeds the specified time limit. By default there is no time limit setting; however the limit can be assigned using the Timeout command.

ONRUNTIMEOUT

This label is called when the Run command calls the external application and the application does not exit in the specified time limit. By default there is no time limit setting; however, one can be assigned using the Runtimeout command.

ONHANGUP

This label is called only when the caller hangs up the line. Normally contains any cleanup code that has to be performed at the end of the call. Hangup command does not cause this label to be called.

ONSYSTEMERROR

This label is called when an internal system error occurs. The actual error that occurred is given in the $Error variable. Normally the code given here logs the error, executes Hangup and jumps back into the “Wait for Ring” loop.